What is a Project?

For the purposes of this program, a project is a collection of pages that form a website which you can work on.

The program offers two types of projects:

• Web projects
• Documentation projects

More often than not the phrase, "projects", simply refers to web projects.

--------------------

Where are projects stored?

Projects are usually stored in your documents folder, in a folder called "Websites being built."

If you are using the portable version of the program, the projects will be stored in a folder of the same name in the same directory as the program.

--------------------

What can I do in the projects menu?

• Edit your pages: At the top of the list will always be the pages of your project. Simply click on one to edit it.
• New page: This adds a page.
• Import Page: This uses the built in HTML parser to import a page into Sunrise Waterfall. Warning! Only elements in Sunrise Waterfall are importable. Any other data may be lost.
• Connect to Wordpress: This, as you would expect,allows you to connect to wordpress. See the section below on Wordpress for more information.
• Generate Site Map: this will get Sunrise Waterfall to create a sitemap.xml file for your website, saving you the effort!
• Manage presets: You can manage your presets here, for instance seeing what they are and deleting them.
• Delete Project: this will completely delete the project from your system.
• Run the link checker: This will get the project to check that all your links are valid including that all internal links match, all websites are real and that all files are present where possible.
• Export project: Exports your project ready for upload.
• Sync via FTP: See the section below on FTP.

Wordpress:

Sunrise Waterfall comes fully integrated with the Wordpress API, allowing you to create and manage your WordPress blog directly from within Sunrise and without having to interact with Wordpress in any form directly.
Through Sunrise you can:

• Publish posts.
• Schedule posts.
• Recategorise posts.
• Tag posts.
• Delete and add tags..
• Delete and add Categories.
• Upload, view and delete items from your media library.
• Edit and delete old posts.

Connecting to Wordpress.

For Sunrise to be able to talk to your WordPress blog you will need to be running wordpress version 4.7 or higher.
Additionally, if you are hosting your blog yourself, you may need the applications password plugin installed, however this does come ready packaged into modern installations.
If you meet the requirements all you need to do is follow the steps in the program which are:

• From the project screen, click connect to wordpress.
• Enter the URL of the blog. Don't forget your https:// in front.
• When prompted on the page that Sunrise will open, click authorise.
• Enter the code you are given into sunrise Waterfall, and you're set!

Having issues?

If your connection suddenly stops working, try deleting the wordpress.info file from the folder of the project and reauthorising.

How does it work?

Once connected to wordpress, your project menu will change.
Instead of having connect to wordpress, you will now instead have two new items:
Download or delete a post: As the name suggests you use this to download posts for editing, or delete old posts you no longer want. Once downloaded, Wordpress posts appear as standard pages from within Sunrise but with some extra buttons for you to play with.
Manage media library: This allows you to upload, view and delete items from your media library. this is all very self explanatory so I won't go into too much detail. Up and down arrow keys to navigate lists, tab to navigate the upload screen and enter to bring up the menu for viewing or deleting.

Creating brand new Wordpress posts.

Once the project is connected to Wordpress, there will be a new checkbox in the new page screen called "this is going to be a Wordpress Post." check this box to ensure that you have the extra buttons that you will want for your new post.
Other than that though, new posts are treated like regular pages within Sunrise Waterfall and can be edited in the same way, see the below sections for more information.

Page screen changes with Wordpress.

When connected to a Wordpress blog and editing a Wordpress post, the page screen has a few extra buttons for you to use.
Press tab to navigate to them (remember the first tab will get you to the insert button, or if you've not got to that section yet... Surprise! the first tab gets you to the insert button, tab past that.)
the other buttons are as follows:

• Manage categories: This will bring up a list of the categories that your Wordpress Blog has. If the category has a * in front of it it means that the post you are currently editing is in that category. to put the post in a category or to remove it from a category, simply press enter on it. Scroll to the bottom of this screen to create new categories. Remember, changes will not take affect until you publish the post.
• Manage Tags: This will bring up a list of the tags that your Wordpress Blog has. If the tag has a * in front of it it means that the post you are currently editing has been tagged with this tag. to tag the post in a tag or to remove it from said tag, simply press enter on it. Scroll to the bottom of this screen to create new tags. Remember, changes will not take affect until you publish the post.
• Publish Post: this brings up five lists that are, from left to right, year, month, day, hour, minute. Use these lists to schedule your posts, or alternatively Sunrise Waterfall automatically has them all set to the current day and time, so simply tab across to okay to publish your post right now.

FTP:

FTP stands for file transfer protocol and SFTp stands for secure file transfer protocol.
Now you know a random fact for the next pub quiz!
Aside from that though, SFTp is a way of sending files from your computer up onto your web server.
To be able to do this, you need an FTP client.
Sunrise Waterfall comes built in with a simple FTP client, though for anything more than the basics it is recommended you use an external, third party client.
That all being said, the FTP client in Sunrise will serve the purpose of upload!

So how does it work?

First, you will need the following information before we begin:

• Host: This is the address for your website.
• Port: You can usually leave this at the default(22), though some server providers may advise you use another.
• Username: This will be your FTP username, given to you by your server provider.
• Password: This will be your ftp password, given to you by your server provider.

Note: Sunrise Waterfall can save your FTP details for you so that next time you click connect, they are automatically filled out. this is an optional feature and is not enabled by default. To enable it, check the box before the connect button.
Further, passwords are not stored for security reasons and therefore must be entered each time.

After connecting:

After connecting you will be put in a file list showing the files currently on your server, including directories.
You navigate this with your arrow keys, pressing enter to go into a directory and backspace to go back one level.
You can also click the two dots ("..") at the top to go back one level.
If you press the applications key on a file, you can:

• Delete it.
• Download it.
• Change who owns it.
• Change the permissions of it.
• View the information about it.

By pressing tab you can navigate to the following:

• Upload a page: This will allow you to either upload a page from your current project, or further down, allow you to upload a file from your computer.
• Upload all pages: this allows you to upload the entire project.
• Close: Disconnect from the server.

Note on uploads:

Where necessary, Sunrise Waterfall will export pages before it uploads them, but be aware if the export fails for some reason (sunrise will tell you about this) it may upload the broken page.

Built with thanks using Sunrise Waterfall by Nathan Tech.